##############################################################################
#
# AIX 3.2 Internationalization Sample Environment Package
#
# (C) COPYRIGHT International Business Machines Corp. 1989 All Rights Reserved
#
# US Government Users Restricted Rights - Use, duplication or disclosure 
# restricted by GSA ADP Schedule Contract with IBM Corp.
#
# INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PACKAGE OF SAMPLE
# ENVIRONMENT FILES, BOTH INDIVIDUALLY AND AS ONE OR MORE GROUPS, AS IS, 
# WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT
# LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
# PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE 
# SAMPLE ENVIRONMENT FILES, BOTH INDIVIDUALLY AND AS ONE OR MORE GROUPS, IS
# WITH YOU. SHOULD ANY PART OF THE SAMPLE ENVIRONMENT PACKAGE PROVE DEFECTIVE,
# YOU (AND NOT IBM) ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICE, SUPPORT,
# REPAIR OR CORRECTION.
#
# Each copy of the AIX 3.2 ILS Sample Environment Package or derivative work
# thereof must reproduce the IBM Copyright notice and the complete contents of
# this notice.
#
##############################################################################
 
Demo of AIX 3.2 NLS -- 10/15/93

I. Installing the Demo under CDE.

   A. As root, create a special user for the the demo:

      1. Use smit and select the following menu entries:

	 smit
	    Security & Users
	       Users
		  Add a User
		     
      2. Specify the User NAME (e.g. "demo"), and execute the command.
	 The rest of these instructions will assume that the user name is
	 "demo". If a different name was used, the commands and pathnames
	 should be modified accordingly.

      3. Set the user's initial password:

	 smit
	    Security & Users
	       Passwords
		     
   B. Log in as "demo" and unpack the files as follows, fron inside demo's home
      directory:
      
      1. If the demo was received as a diskette, untar the files 
	 from the diskette, by executing the following command:

	 tar -xvf/dev/rfd0

	 Otherwise, download or copy the following files to the demo user's
	 home directory:

	    nlsdemo.announce -- introduction to demo
	    nlsdemo.readme -- instruction file
	    nlsdemo.install -- executable installation script
	    nlsdemo.tarzbin -- compressed tar file containing demo

      2. Compile any programs needed

	 cd $HOME/src
	 make install    # this will build the binaries and ln to $HOME/bin

	 You will need to go and get your own copy of xmeditor from
	 the Motif sample directory.  Make sure you add a XtSetLanguageProc()!

      4. Customize the tables for your specific system.

	 $HOME/tables/ASCII        # this is DB of all the locales, refer
				   # $HOME/tables/Readme

		************ NOTE: most of the scripts are written to 
		************ 	   depend on COSE locale names.  But this
		************       file maps COSE locale names to system
		************       locale names.


	 $HOME/bin/genActions      # This defines the commands to be 
				   #   be invoked.  The rule is that each
				   #   command will be invoked using
				   #   $CMD %L.  Refer to COMMAND_NAMES setting.
				   #   DO NOT CHANGE ANYTHING ELSE.  We should
			  	   #   make this a seperate table, but...
				   #
				   #   HINT: 1st time, just make sure langterm
				   #   is working since it uses dtterm!
	 $HOME/bin/lang*           # For each command, do any special
				   #  customization.  The main thing done
			           #  is to pass the font base name to for
				   #  a given locale.
	 $HOME/bin/setkb           # This is to set the keyboard to the 
				   #  the locale of the flag prior to 
			           #  invoking the cmd.  The keyboard becomes
				   #  active for all windows!  So there is
				   #  an menu to explicitly set the keyboard
				   #  to any other language.  (What is 
				   #  really needed is a way to say ignore
				   #  keyboard remaps, but....
	 $HOME/bin/getSysLocale    # This checks if the specific locale is
				   #  valid

      3. Generate the rules files

	 gendt           	# This will generate a flag for each
				# Check /tmp/gendt.log for any errors.
				# if ok, we are ready

      4. Bring up tools files.

	 cd $HOME/.dt/types/tools   For now this the only way we have figured
	 dtfile -dir $PWD	    how to get the Globe icon.   We'll work
				    get it more intergrated later.  

		

   D. Test the installation (logged in as demo):

	Once the Globe is displayed.

      1. Click on Globe to see flag icon.

      2. Click on any flag and see the set of menu items defined by
	 gendtActions.  clicking on an item will invoke the Cmd_To_Exec
	 from the gendtActions.  From here you are on your own.


	 langterm Test

	 a. langterm en_US - make sure you get US keyboard mapping.
	 b. langterm fr_FR - make sure you get FR keyboard mapping.
	 c. langterm ja_JP - make sure IM comes up, JP font (large) and
			     JP keyboard is set.


